home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / standard / sboxf.z / sboxf
Encoding:
Text File  |  1998-10-20  |  4.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ssssbbbbooooxxxxffff((((3333GGGG))))                                                            ssssbbbbooooxxxxffff((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ssssbbbbooooxxxxffff,,,, ssssbbbbooooxxxxffffiiii,,,, ssssbbbbooooxxxxffffssss - draw a filled screen-aligned rectangle
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd ssssbbbbooooxxxxffff((((xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222))))
  13.      CCCCoooooooorrrrdddd xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222;;;;
  14.  
  15.      vvvvooooiiiidddd ssssbbbbooooxxxxffffiiii((((xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222))))
  16.      IIIIccccoooooooorrrrdddd xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222;;;;
  17.  
  18.      vvvvooooiiiidddd ssssbbbbooooxxxxffffssss((((xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222))))
  19.      SSSSccccoooooooorrrrdddd xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222;;;;
  20.  
  21.      All of the above functions are functionally the same except for the type
  22.      declarations of the parameters.
  23.  
  24. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  25.      _x_1   expects the _x coordinate of a corner of the filled box.
  26.  
  27.      _y_1   expects the _y coordinate of a corner of the filled box.
  28.  
  29.      _x_2   expects the _x coordinate of the opposite corner of the filled box.
  30.  
  31.      _y_2   expects the _y coordinate of the opposite corner of the filled box.
  32.  
  33. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  34.      ssssbbbbooooxxxxffff draws a filled, two-dimensional, screen-aligned rectangle.  The
  35.      rectangle is drawn as a single polygon, and therefore inherits many
  36.      properties that affect the drawing of polygons.  These include the
  37.      current color, writemask, fill pattern, and subpixel mode.
  38.  
  39.      The sides of the rectangle will be parallel to the screen _x and _y axes.
  40.      This rectangle cannot be rotated.  The _z coordinate is set to zero.
  41.  
  42.      When you use ssssbbbbooooxxxxffff, you must not use alpha blending, backfacing or
  43.      frontfacing, depthcueing, fog, gouraud shading, lighting, polygon
  44.      antialiasing, screen subdivision, stenciling, texture mapping, or z-
  45.      buffering.  ppppoooollllyyyymmmmooooddddeeee must be set to PYM_FILLED.
  46.  
  47.      ssssbbbbooooxxxxffff may be faster than rrrreeeeccccttttffff on some machines.  Use ssssbbbbooooxxxxffff when you need
  48.      to draw a large number of screen-aligned rectangles.
  49.  
  50.      After ssssbbbbooooxxxxffff executes, the graphics position is undefined.
  51.  
  52. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  53.      backface, bgnpolygon, blendfunction, depthcue, frontface, glcompat,
  54.      lmbind, polymode, polysmooth, rectf, scrsubdivide, setpattern,
  55.      shademodel, stencil, subpixel, texbind, zbuffer
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ssssbbbbooooxxxxffff((((3333GGGG))))                                                            ssssbbbbooooxxxxffff((((3333GGGG))))
  71.  
  72.  
  73.  
  74. NOTE
  75.      By default ssssbbbbooooxxxxffff draws a polygon using the old-style scan conversion
  76.      algorithm, rather than the point sampling algorithm used by bbbbggggnnnnppppoooollllyyyyggggoooonnnn
  77.      and eeeennnnddddppppoooollllyyyyggggoooonnnn.  Point sampling is prefered over old-style scan
  78.      conversion because it has higher performance.  Call
  79.      ggggllllccccoooommmmppppaaaatttt((((GGGGLLLLCCCC____OOOOLLLLDDDDPPPPOOOOLLLLYYYYGGGGOOOONNNN,,,,0000)))) to enable point sampling of polygons generated
  80.      by ssssbbbbooooxxxxffff.
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.